---
title: "Introduction"
description: Leverage the power of headers in your proxy request with Helicone to unlock advanced features and capabilities.
---

# Utilizing Headers

<CodeGroup>

```bash Curl
curl https://gateway.hconeai.com/v1/completions \
  -H 'Content-Type: application/json' \
  -H 'Helicone-Auth: Bearer HELICONE_API_KEY' \
  -H 'Helicone-<HEADER>: <VALUE>'
  -d ...
```

```python Python
openai.api_base = "https://gateway.hconeai.com/v1"
openai.Completion.create(
    model="text-davinci-003",
    prompt="This is a test",
    headers={
        "Helicone-Auth": f"Bearer {HELICONE_API_KEY}",
        "Helicone-<Header>": "<Value>",
    }
)
```

```typescript Node.js v4+
const openai = new OpenAI({
  baseURL: "https://gateway.hconeai.com/v1",
  defaultHeaders: {
    "Helicone-Auth": `Bearer [HELICONE_API_KEY]`,
    "Helicone-<Header>": "<Value>",
  },
});
```

```typescript Node.js <v4
import { Configuration, OpenAIApi } from "openai";

const configuration = new Configuration({
  basePath: "https://gateway.hconeai.com",
  baseOptions: {
    headers: {
      "Helicone-Auth": `Bearer [HELICONE_API_KEY]`,
      "Helicone-<Header>": "<Value>",
    },
  },
});

const openai = new OpenAIApi(configuration);
```

```python Langchain (Python)
llm = ChatOpenAI(
    openai_api_key="<OPENAI_API_KEY>",
    openai_api_base="https://gateway.hconeai.com/v1",
    headers={
        "Helicone-Auth": "Bearer <HELICONE_API_KEY>",
        "Helicone-<Header>": "<Value>",
    }
)
```

```javascript LangChain JS
const model = new ChatOpenAI({
  azureOpenAIBasePath: "https://oai.hconeai.com",
  configuration: {
    organization: "[organization]",
    defaultHeaders: {
      "Helicone-Auth": `Bearer ${heliconeApiKey}`,
      "Helicone-<Header>": "<Value>",
    },
  },
});
```

</CodeGroup>

# Supported Headers

| Header Name              | Type           | Description                                                                                                                   | Example                                               |
| ------------------------ | -------------- | ----------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------- |
| Helicone-Target-URL      | string (url)   | The URL to proxy the request to when using gateway.hconeai.com                                                                | https://api.openai.com/v1/engines/davinci/completions |
| Helicone-OpenAI-Api-Base | string (url)   | The URL to proxy the request to when using oai.hconeai.com                                                                    | https://[YOUR_AZURE_DOMAIN].openai.azure.com          |
| Helicone-Request-Id      | string (uuid)  | The ID of the request                                                                                                         | 123e4567-e89b-12d3-a456-426614174000                  |
| Helicone-Omit-Response   | boolean        | Whether to exclude the response from the request                                                                              | true                                                  |
| Helicone-Omit-Request    | boolean        | Whether to exclude the request from the response                                                                              | true                                                  |
| Helicone-Model-Override  | string (model) | Overrides the model used to calculate costs and mapping. Useful for when the model does not exist in url, request or response | gpt-4-1106-preview                                    |

# Feature Flags

| Header Name                  | Type    | Description                                                                                     | Example |
| ---------------------------- | ------- | ----------------------------------------------------------------------------------------------- | ------- |
| Helicone-Stream-Force-Format | boolean | Enforce proper stream formatting for libraries that do not inherently support it, such as Ruby. | true    |
